home *** CD-ROM | disk | FTP | other *** search
/ Visual Cafe for Windows 95 & Windows NT 4.0 / Symantec Visual Cafe for Windows 95 and Windows NT 4.0 (Symantec) (1996).iso / vcafe / readme.txt < prev    next >
Text File  |  1996-12-14  |  13KB  |  347 lines
  1. README for Symantec Visual Cafe Version 1.0
  2. ================================================================
  3. Copyright (c) 1996 by Symantec Corporation. All Rights Reserved.
  4.  
  5. Table of Contents:
  6. I.     Welcome
  7. II.    Installation Notes
  8. III.   User Tips
  9. IV.    Known Problems
  10. V.     Contacting Symantec for Technical Support
  11.  
  12.  
  13. I.  Welcome!
  14. ================================================================
  15. Welcome to Symantec Visual Cafe Version 1.0 for Windows 95
  16. and Windows NT.  Please take a few minutes to read this file.
  17.  
  18.  
  19. II.  Installation Notes
  20. ================================================================
  21. If you have previously downloaded the Preview Releases, you must 
  22. remove them before installing Visual Cafe 1.0. 
  23.  
  24. Run setup.exe. The installation is smooth and intuitive. As with
  25. any new software, please install Visual Cafe in a clean
  26. directory.
  27.  
  28.  
  29. Installing and Running the Tutorial
  30. ---------------------------------------------------------------
  31. If you are new to Java development, please take the time to work
  32. through the exciting and informative tutorial that is part of 
  33. Visual Cafe.  This tutorial will provide you with an overview 
  34. of Visual Cafe's most powerful features. 
  35.  
  36. If you are using Microsoft's  NTFS do not install into a
  37. directories containing spaces.
  38.  
  39. What's in the Tutorial?
  40. ---------------------------------------------------------------
  41. In the Tutorial you will learn how to:
  42.  
  43. * Design an applet, then build, and install it in a Web page.
  44. * Run the applet in a Web browser.
  45. * Design an application, then build, test, debug, and run it.
  46.  
  47.  
  48. III.  User Tips
  49. =================================================================
  50. How do I add values for each column in a multi-list control?
  51. When using multiple columns in the multi-list control you must
  52. separate the column values with a semi-colon.  Each row is
  53. separated with a ctrl + enter.
  54.  
  55.             *
  56.  
  57. How do I configure my Web browser to run an applet I created 
  58. using custom classes?
  59.  
  60. When you are ready to view your applet outside the Visual Cafe 
  61. environment, you need to make sure that the AppletViewer or your 
  62. favorite WWW browser can find the custom classes included with 
  63. Visual Cafe.  For local browsing, add an environment variable to 
  64. your autoexec.bat or system or config.sys file, such as:
  65.  
  66.     CLASSPATH=C:\visualcafe\java\lib\symclass.zip.  
  67.  
  68.             *
  69.  
  70. How do I distribute my applet on a Web server?
  71.  
  72. -When placing the applet on a WWW server, contact your  
  73.  Webmaster and verify that the Symantec classes are 
  74.  available.  If the classes are not available on your server, 
  75.  the Webmaster will need to add them or tell you how 
  76.  to add them.  If you are the Webmaster, the classes in 
  77.  the symclass.zip file need to be in the server's classpath.
  78.  
  79. -A solution that works locally, or from a server, is to copy the 
  80.  \VisualCafe\Java\Lib\symantec directory and all of its contents
  81.  to the directory containing the applet. (The subdirectories of
  82.  the "symantec" directory contain the Visual Cafe Java runtime
  83.  classes.)
  84.  
  85. -Due to a large number of requests late in the beta cycle of 
  86.  Visual Cafe,  we have included an early version of our Bundler 
  87.  utility that will allow you to easily figure out which class
  88.  files are used by your applet (or application), and need to
  89.  be uploaded to your web server.  Once your Java app is ready,
  90.  execute the following command at the command prompt 
  91.  (please make sure that \visualcafe\bin is in your path):
  92.  
  93.  Bundler.exe -make -cdb mainclass.cdb -depend listname.dep
  94.                 mainclass.java
  95.   (this is all one command line)
  96.  
  97. - where mainclass is the name of the main class Java file or the
  98.   project name 
  99.  
  100.   in this example, listname.dep is the file name where the list
  101.   of classes used by your app will be generated.  Please note
  102.   that Bundler will also list the name of the zip file (if any)
  103.   where the class file was found.  This will allow you to know
  104.   what class files you would need to unzip from each class zip
  105.   file used by your app.  Please note that in this version,
  106.   the file listname.dep has to have a .dep extension.
  107.   Please note also that while the java.* class files are logged
  108.   in this file, you are not actually required to copy those
  109.   to your web server, as they are usually available with
  110.   most Internet browsers.  Please also note that Bundler takes
  111.   the same other command line options as the sj command line
  112.   compiler.  So, you can add additional class paths, etc.
  113.  
  114.             *
  115.  
  116. What is the "Execute applet in default HTML viewer" option in
  117. the Project Options dialog?
  118.  
  119. The "Execute applet in default HTML viewer" option, located in 
  120. the Project Options dialog box, allows you to view your applet 
  121. in your favorite WWW browser, instead of the AppletViewer, 
  122. when executing from the Visual Cafe environment.
  123.  
  124.             *
  125.  
  126. Will Visual Cafe recognize my own source code?
  127.  
  128. When adding controls directly within the source editor, it 
  129. is recommended that you adhere to the same coding style as 
  130. generated by Visual Cafe.  This will allow controls you add
  131. to be displayed in the form editor.  Controls you add outside 
  132. Visual Cafe's tags will not be displayed in the form editor 
  133. and will not be affected by automatic code generation.
  134.  
  135. For example, if you are adding controls within Visual Cafe's
  136. tags in the source editor, you should adhere to Visual Cafe's
  137. coding style.  Otherwise, you can add controls outside Visual
  138. Cafe's tags using your own coding style.
  139.  
  140.             *
  141.  
  142. What do I need to do to enable Remote Debugging?
  143.  
  144. If you are using cafeRemote on a remote computer for remote 
  145. debugging you must modify the autoexec.bat file on that 
  146. machine. You must also include VisualCafe\java\bin in your
  147. PATH, and create and set a CLASSPATH system variable 
  148. to include all necessary classes for the Applet or Application 
  149. you are debugging. Here is an example:
  150.  
  151. set PATH=C:\VisualCafe\Java\Bin;%PATH% 
  152. set CLASSPATH=C:\VisualCafe\Java\Lib;
  153. C:\VisualCafe\Java\Lib\SYMCLASS.ZIP;
  154. C:\VisualCafe\Java\Lib\VECCLASS.ZIP;
  155. C:\VisualCafe\Java\Lib\SYMANTEC.ZIP;
  156. C:\VisualCafe\Java\Lib\SYMANTEC.ZIP;C:\YOUR_CLASSES
  157.  
  158. Note that a PATH or CLASSPATH statement in your system files 
  159. is one continuous line with no spaces or carriage returns.
  160.  
  161.  
  162. IV.  Known Problems
  163. ================================================================
  164. This section lists information on known problems:
  165.  
  166. * If you encounter an error upon starting Visual Cafe or if your
  167.   tool palette appears empty delete the following files from
  168.   \visualcafe\bin:
  169.     *.rps
  170.     *.reg
  171.     *.vws
  172.  
  173.   Note: Some of the errors are:
  174.     "No starter templates could be found"
  175.     "Cannot open local repository"
  176.     "Cannot open registry"
  177.  
  178.   These files are platform-dependent and must be regenerated
  179.   when switching from one OS to another.  
  180.  
  181. * Due to architectural changes within Visual Cafe projects, we
  182.   are not compatible with Preview 1 or 2 .VPJ files.
  183.  
  184. * When using the Parse All Imports option, we recommend that
  185.   you allow the parser to finish parsing before editing or
  186.   changing a file.  To view the status of the parser, select
  187.   Messages from the Visual Cafe Window menu.
  188.  
  189. * The x and y dimension properties in the Property Inspector
  190.   are not applicable for root level objects.  No effect is
  191.   achieved if you change these settings.
  192.  
  193. * Visual Cafe introspects class file when they are added to the 
  194.   Component Library, and allows the setting of basic properties 
  195.   in the property list if the class follows the Java Beans spec.  
  196.   Supported properties are: int, boolean, String, String arrays, 
  197.   Color, Font, URL, and URL arrays.  Currently the additional
  198.   is/set design pattern for boolean properties is not supported.
  199.  
  200. * If you would like to disable Live controls you may rename 
  201.   jblender.dll to jblender.sav.   
  202.  
  203.  
  204. Low-memory warning on startup
  205. -----------------------------------------------------------------
  206. If the sum of your system's available physical memory (RAM) and
  207. swap space on disk is below a minimal level when Visual 
  208. Cafe starts up, a warning dialog will notify you of this
  209. condition.  We will  advise you to increase swap space (see
  210. below).  You have the option of ignoring this warning (answer 
  211. "No" to the "Quit?" prompt), and proceeding to run Visual Cafe. 
  212. With light use, you may not experience any problems at all. But
  213. with typical use, at some time in the course of your Visual Cafe 
  214. session you may begin to see "low virtual memory" warnings from 
  215. the operating system.  Typical symptoms of running any complex 
  216. application with too little available memory are sluggish 
  217. performance and unstable system behavior.
  218.  
  219. If the warning dialog recommends that you increase swap space by 
  220. some small amount, such as 2 or 3 MB, please increase minimum 
  221. swap space on Windows NT, or free disk space on Windows 95, by 
  222. at least 5 MB.
  223.  
  224. On Windows 95, if the option is selected in 
  225. Settings | Control Panel | System | Performance | Virtual Memory
  226. to let the OS manage swap space (this is the default), then 
  227. available swap space is simply the amount of free disk space; 
  228. but note that there is no guaranteed minimum:  if the disk is
  229. full there is no swap space available.
  230.  
  231. On Windows NT 3.51, Control Panel is started from Program
  232. Manager; on Windows NT 4.0, Control Panel is started from
  233. the Settings menu item, as on Windows 95.  The page file
  234. setting that matters most to an application on NT is the
  235. minimum page size setting.  On a system with 32 MB RAM,
  236. the minimum swap space should be not less than 20 MB, and
  237. 32 MB is better. A reasonable setting for
  238. the maximum is at least twice the minimum.
  239.  
  240. For further details about virtual memory, see the OS Help
  241. on the System dialog.
  242.  
  243.  
  244. JDK Version Incompatibilities
  245. -----------------------------------------------------------------
  246. Symantec Visual Cafe 1.0 supports version 1.0.2 of the Java 
  247. Development Kit from Sun Microsystems.  
  248.  
  249. Some behaviors of the java.awt components are not correct on
  250. the Microsoft Windows platforms.  
  251.  
  252. These platform-dependent problems include:
  253.  
  254. * Buttons and labels do not support foreground or background
  255.   colors.
  256. * Checkbox/radiobuttons don't support foreground color.
  257. * Lists size themselves to specific increments (to completely
  258.   hold lines of text). 
  259. * When building applets/applications for Microsoft Internet
  260.   Explorer you should not use the project option for Java
  261.   Optimization or the -O switch.
  262. * When calculating the Client area, awt does not take into
  263.   account the menubar.  As a result your forms may not appear
  264.   as WYSIWYG.
  265. * Choice and List components incorrectly display their size and 
  266.   position if not used in conjunction with a layout manager.
  267.  
  268.    Visual Cafe issues a reshape after the component is added 
  269.    which addresses this problem. However, if you try to use 
  270.    descendants of these classes you will need to add a call to
  271.    reshape after the component has been added.  For example,
  272.     
  273.     Assuming newChoice extends Choice
  274.     //{{INIT_CONTROLS
  275.     newChoice1 = new newChoice();
  276.     newChoice1.reshape(119,72,135,21);
  277.     add(newChoice1);
  278.     //}}
  279.     
  280.     // Add this section after the init block:
  281.     newChoice1.reshape(119,72,135,21);
  282.     
  283.  
  284. JDK 1.1 Support:
  285. -----------------------------------------------------------------
  286.  
  287. We are planning to aggressively support JDK 1.1 as soon as it is
  288. available.
  289.  
  290. We will provide pre-release versions of Visual Cafe on the
  291. Update Center at cafe.symantec.com that will provide support 
  292. for the pre-release versions of JDK 1.1 as they are rolled out
  293. of JavaSoft. You can also count on a free upgrade to Visual Cafe
  294. with JDK 1.1 support shortly after the final version of
  295. JDK 1.1 ships!  So, make sure to register on cafe.symantec.com
  296. and subscribe to the mailing list so we can notify
  297. you when new updates to Visual Cafe are available.
  298.  
  299.  
  300.  
  301. V. Contacting Symantec for Technical Support
  302. ================================================================
  303.  
  304. During the first 90 days of your purchase, you may call Technical
  305. support free of charge at (541) 465-8470.
  306.  
  307. 1.  Free and unlimited electronic support is available at on
  308.     symantec's news server at service.symantec.com.
  309.  
  310.     Please refer to the news groups under 
  311.     symantec.support.devtools.pc.visual-cafe
  312.   
  313.     Note: your company's firewall may prevent you from accessing
  314.     this service.
  315.   
  316.     Support is also available on the usenet newsgroup  
  317.     comp.lang.java
  318.  
  319.     Send bug reports to Support_javawin@symantec.com
  320.  
  321. 2.  If your User ID and Password become inoperative, please send 
  322.     e-mail notification to Customer Service at
  323.     custserv@symantec.com with your name, address, daytime phone
  324.     number, ID and password.  Please type "Visual Cafe" in the
  325.     subject field.  We will respond shortly thereafter.
  326.   
  327. 3.  If you have lost your Cafe ID set, please send notification
  328.     to Customer Service at custserv@symantec.com.  In the event
  329.     that your information does not appear in our registration
  330.     database, we will provide additional avenues for
  331.     verification of ownership. 
  332.  
  333. 4.  For CD purchases or damaged disks please call Customer Service 
  334.     at 800-441-7234.   
  335.  
  336.  
  337.         *  *  *  *  *
  338.  
  339. Thank you for using Visual Cafe.  We are confident it will assist you 
  340. with your development efforts.
  341.  
  342. Sincerely,
  343.  
  344. The Symantec Internet Tools Team 
  345.             
  346.  
  347.